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Basic09 Part-7 

Tutorial 

^^Y $99tf Hofiftk^ ^ Rodg er 

l^ell, as promised, here is the 
SEARCH routines for our PDS 
Database, IVe divided it into two 
procedures and you cotdd easily 
sinq^ the process by restricting 
the field choices and eliminating 
the first procedure altogether. I 
did not go to the trouble of fimcy 
screen formatting, however i 
tbottj^t it might be a nice touch to 
not clear the screen with a *'PRINT 
CHR$(12)" before listing the field <^ons, but instead 
print a block of spaces to blank out the menu options and 
place the field choices at that location, leaving the current 
database disph^ed in it's original position. Then when you 
search routine find the desired record, it would simply 
replace the current record at the top of the screen. BUT, 
ru leave those options to your creativity and programming 
ability. 

HOW IT WORKS: 

When you select "<F>ind** from the Main Menu, the PDS 
Procedure runs **SeardiJ)B(DB_Paa^T^)'', (This is 
assuming you have ahready opened a file and have it 
dispia}ed at the top left comer of the Main Menu screen.). 

LISTING 1: 

The PARAMeter line assigns the proper variable types to 
DB^Patb and Top variables, which were passed to the 
procedure inmi the Main Menu. The DlMension 
statement defines and assigns more fields that will be used 
in the listing. CHR$(12) clears the screen and the n^xt 1 1 
lines print to the screea The field variid>le contains the 
number 1 to 8 from the input statement and will determine 
which variable from the DATA field will be placed in the 
variable **FieldName**. So if you selected "2) Last Name** 
as the field that you want the search routine to base it*s 
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search on, then the value of '*2** will be used 
as the top of the TOR X= 1 TO field" (forx 
* 1 to 2). and the second variable in the 
DATA field (Last Name) will be used for the 
variable FleldName. 

The whole pwnt of the SewrchJ)B 
Procedure is to provide two more variables 
{fiOd and FtMName) to be passed along to 
the actual Seard$ Procedure. Now we have 
the name of the fieki we want to search Ibr 
(for convenience sake) and the field number, 
which is necessary for determining field 
locations and lengths in are record search. 



LISTING 2; 

The first line defines our address variable 
again with each field length and type 
q)ecified for our database. The second line defines the 
variable types passed to the procedure from the last line 
of LISTING L The next three DlMension statements 
coukl have been combined but were separated in this 
case for clarification. The first DIM line identifies the 
string variables and their length, the second identifies 
the byte variables and the third identifies rec as our 
database record variable defined by the TYPE statement 
in the first line of the listing. 

The following PRINT statements are obvious, and the 
INPUT sinq)ly assigns your query to the SearchString 
vari^le. What follows is not so c^ous, so \ixk closely 
at the comments between each execution line for an 
explanation of how the database records are searched at 
specific string locations and those strings are then 
compared to the SearchString^ 

When the SearchString rs found, the record it is 
found in is printed to the screen. A '*Press AnyKey^ 
(»x)mpt is displayed. At this point in the listing, the 
INK£YS command is called tq> in the middle of a 
'^WHILE-DO-ENDWHILE" nested routine. When a key 
press is detected, the Search Procedure is ended aiul we 
are returned to the Main Menu. 

NEXT MONTH, our final chapter (Didn't I s£^ that last 
month) will feature the Pack Procedure. 



LISTING 1 

PROCEDURE Search.DB PRINT "5) City** 

REM database Search Routine PRINT "6) State* 

PARAM DB^Path:BYTE; ToprlNTEGER PRINT -7) Zip Code* 

DIM ficld:BYTE; FieldNaiiie:STRING[12] PRINT "8) Phone Number" \ PRINT 

PRINT CHR$(12) \ PRINT (♦Clear Screen INPUT "Enter choice: ",field 

PRINT "Personal Database System -Search Database" \ PRINT FORx«lTOfieki 

PRINT •Search on which fieW:''\ PRINT RE AD FieklName 

PRINT •!) First Name" NEXTx 

PRINT "2) Last Name** DATA "Fiist Nanie"/Last Name"," Address 1 "/Address 2", 

PRINT -3) Address 1" "City", "State" 

PRINT '*4) Addtess 2" ,*2ap Code","Mione Number" 

RUN search(DB^Path,Top>fieldJieldName) 

USTING2 
PROCEDURE Search 

TYPE address«FName:STRINGtlOI; LName:STRINGI15J; addressLSTRING 
[201; address2:STRING[20]; dty:STRING(I5|; state:S'nUNG[2J; ziprSTRINGIlO]; phone:STRINO[141 
PARAM db_Path:BYTE; Top:INTEGER; field:BYTE; FieldNamc:STRINO[121 
DIM COTii>areStniig:STRING[20]; SearchString:STRING[20]; charSTRING[l] 
DIM ofibet:BYTE; length:BYTE 
DIM rec:address 
char'"" (*Used in the INKEYS roittine 

PRINT CHR$(12) \ PRINT (♦Qear Screen 

PRINT "Personal Data'base System - Search Database" \ PRINT 

PRINT \PRINT 

PRINT "Enter "; FieldNamc; " to find**; \ INPUT SearchString 

PRINT 

F0RX»1 TO field (♦field « value fiiom ScarchDB Procedure 

READ oSisetV READ length (^reading data variaUes in pairs 

NEXTX 

FORcurrent^lTOTop (*Tq>"nuniber of records in database 

SEEK #db.Path,(current*l)*SIZE(iec)+offi9et (♦Seardi each reoofd ^ a specific field locatim ((rfTset) 

GET #db_P3th,CompareString (^assign variable at otbet location to "CompareString" 

ConqKu:eString<^LEFTS(CcHnpareStriQg»tengthH>f&et) (♦Crop "Qm4>areString" var. to the {Koper length 

IF SeardiString»Con4)areString THEN (♦Compare "SetrchString" with your quay ("CompareString") 

SEEK #db„Path,(current-l)^SIZE(rec) (♦Find the beginning of the reccmi with the matching variable 

GET #db_Path,iec (♦Retrieve the reccmi in the "address" format 

PRINT rec.FName; " **; rec.LName (♦print fields to screen 

HUNT rec.addressl 

PRINT rec.address2 

PRINT rec-city; ","; recstate; " ";rec,zip 

PRINT "Phone: "; rec.phone 

PRINTVPRINT 

HUNT "Press Any Key to Continue. . " 

WHILE char-"" DO (♦INKEYS lontine p]}S Database 00 DISK 

RUN inkey(char) The complete database is available on 5-1/4 inch 35 

ENDWHILE jj3^ Sj^^ Sijgj jyi^ foj.„^l fof ji (and ^^^ includes 

^^*® postage and a &ncy disk label). Mail your order to OSS> 

^^®^ Newsletter, 3404 Illinois Lane. Bellingham. WA 98226 

NEXT current 

DATA 0.10,25,45,65,80,82,92,106 



1,2 and 1.4 High Density Floppies on vour CoCo 

Instruction fttf modifying the OWGINAL RADIO ^ 

The c<mt]X)ller\fUST be the (Hie with the fUl sized bofo^ Accxmiing 

to the Western Digital manu^ the 1773 (osed in the neii«r cmtrdlens) CANNOT do Ugh den^ 

This modification is NOT for the &uit of heart or those unexperienced with hardware modifications. If you don*t know what 
"piggyback* means vAicn lefering to diips, foig^ iti This modtficatitm requires 32 soldaing connections, 1 8 jvaapcr wires and 
a lot of patience. Do this on you dd spare controUer if you can. The old ocmtroUer needs 12 volts therefore you MUST have a 
multipak orequtvalem. This modification win allow the oontroUer to use either 250 kbs or 500 kbs data transfer late. This is 
the difiBpnmce between the standard 5.25* 360k <ff3J* 720k drives and a 5.25* 1.2 m^ or 3.5" 1.4 m^ drive, 

WHAT YOD NEED: 

1 74LS74 

1 74LS158 

1 3.9k 1/4 watt resistor 

1 mini DPDT toggle switch (opticmal) 

Wire for the junq)ers. fl reccmmiend standard wire wr^ wire as RS carries. This is vciy inqxniant, DO NOT use thidc wire. 
Wire wrap wire is 30 gange< Just ri^rt fior these kind of prqjects.) 

The mod will be dcme so if a mistidce is made and you want to abandon it, you can just remove all of the jumpers plug in 
replacement chips far the ones piggybacked to and youll be back to v/bac you started. If you want this option, buy an extra 
74LS74 and a 74LS22L There are NO trace cuts in this mod. IC pins are left out of the sodcet to get the equivalent of a trace 
cut. If you need to reverse t he mo d, those pins MUST be reinserted into their respective sodcets. There is ABSOLOTLY NO 
GUARANTEE OR WARANTEE EXPRESSED or IMPLIED FOR Tins MODMCATION. N^ 

We wiU be piggybacking a 74LS74 on to the existing 74LS74 at ICl. We will also be i»ggybadking a 74LS158 onto the 
74LS221 at IC7. Smie other chips will be soldered to and some pins will be removed firom the sodcets fi>r some ICs. These 
instructions will be entirety veibal, no illustrations. 

First, remove Ul {74LS74) flom it's sodceL Positim a new 74LS74 <m top of it with the pins EXACTLY overiapping (this is 
called piggybacking). Be aire both pin l*s are lined i4> or itll be poof time whoi you apply the power. On the upper 74LS74, 
bend up pins 2,3,5,6,8,9,10,11,12 and 13 so they pmnt directiy aw^ fitrai ihc body of the IC. Pins 1,4,7 and 14 should still 
be ov^l^jpingUie tower 74LS74. Carefidly solder these pairs (tf pns together being carefol not to Mob the solder onto ttie legs 
of the lower 74LS74 as you wiU be plugging the pair (stack) ctfcltips bade into the Ul sodo^ 
bend pin 1 1 out away fixmi the body of die chip as you did for some of tiie pins (m the upper IC. Pin 1 1 wm 
into the socket. Pr^are six 3** jampcr wires (prepare means stiq) back tiie insulation on each end of tiie wire, no more than 
l/16^ Then tin the e?q>osed wire on each end of the junq«X Sdder the wires to the 
One end of each wire will be unconnected, 

1 junq)er to pin 1 1 on the lower IC (the pin sticking out) 

1 jumper to the lower IC imi 3 (must still be Mc to go into the socket) 

1 junker u> die kywer IC pin 6 (must also be able to go bade into the socket) 

2 junq)ers the the upper IC pin 3 
1 junq)er to the iq)per IC pin 6 

Also, prepare a 1.5"* wire and solder it from tiie nppex IC pin 2 to the upper IC pin 6 taking care not to disconnect tiie wire 
already on the i^per IC fin 6. You m^ now careftdly plug the IC stack back into die ICl sodcet making sure all pins get 
seated into the socket with the exception of pin 11. 

Seccmd, we*U be dmng a similar iHggyback mod to tiie 74LS221 in ti^ U7 soctetRemove tiie 74LS221 finom tiie sodcet 
Posttim tiie 74LS158 on top of tiie 74LS221 Make sure that the two ICs are pn3perly digned and that tiie two pin Ts 
are aligned together. Bend tq) all of tiie inns <m tiie iqjper IC EXCXPT pins 8 and 16. sddor tiie two pin 16*s togetiier and also 
sold^ the two pin 8*s togetiier. As before, make sure not to bk)b scdder on tiie legs as tiie sta^ 

socket. Bend pin 13 on tiie lower IC away fiom tiie body of tiie IC so it cannot be reinserted into die socket. Prepare four 
1 .5" jun4)er$, one 2** junker and one 3" jumper. Sokkr tiion in as foUows: 

12" junqier to the lower IC |^ 2 

1 1.3''jun4)erfiomthejoinedpin8*stotheiq)perIC{»n 15 

1 1 .5** junqier fiom the upper IC ]nn 1 S to the upper IC i»n 10 (taking care 
to not disconnect the wire already at pin IS) 



1 l.S** junker fiom the tied together pin I6's to the upper IC pin U 
1 1 .5** juiq>er to the upper IC pin 7 
1 3''juinpertothetq)perICpinl 



" jumper to the tq)per IC pin ] 




Plug the $task bock ino the U7 socket making sure all of the pins art seated firmly EXCEPT pin 13 which should be sticking 
out. Solder a 3.% resistcn^ from the iq)per IC pin 9 to the side of R18 (3.9k) which is tte 

Ffaial Asf^My 

Remove Ull (the 74LS629). Solder one of the 3** junker wires fnnn Ul, the iqiper 74LS74 pin 3 to the top ctf the 74LS629 pin 
7 making sure not u> blob solder. Plug Ull bade in making sme ALL of the legs seat firmly into the sod^t XJtsfAng U3 (7406 
or 7416). Qmnect the 2* wire firom the lower IC pin 2 (rfthe dack at U7 to the top (tf pin 1 of the IC that was in U3 (making 
sure not to blob sohler on the leg). Plug U3 back into it's socket making sure all ctf the legs seat firmly into the socket 
Solder the open end of the jumper connected to UlkiwerIC pin 11 to U7iqiper IC|Hn4 
Solder the open end ofthejumper connected to UlkywerIC pin 3 to U7 upper ICpin3 
Sokler the open end of the jumper connected to UlkrwerIC pin 6 to U7iq)per ICpin2 
Sokfer the open end ofdiejuniper connected to Ul upper IC|Mn 6 to U7iq;qpe^ ICpin5 
Scrfder the open end ofthejumper connected to UltqiperlC pin 3 to U7ivper ICpin6 

g»Wfff l^lhyftBffiyJIBgfflWtWtfWH^ 

Select optioB 1 - using WRTIC PRECXDMP bit and a SWrrciI (F<»r Hard Drive b^ 

somewhere handy. I mounted mine in the hole near CI and the piggybacked 74LS74's. Make sore that the switch DOESNT 

SHORT OUT any traces! IH refer lo the switch jnns as follows : 

pin 2 toggles between pins 1 & 3 
pin S to^es between pins 4 A 6 

Carefully remove U12 (the 1691)&mn its socket. Bend iq>{rin$ 9 and 16 away fiom the body. Pot the 1691 bade into the U12 
socket making sure that all pins firmly seat with the excepticms of pins 9 A 16. 

Prepare and solder a 4** junspct fiom U12 (1691) pin 9 u> the DPDT switdi ]Hn 5. 
Solder die open end of the jumper connected to U7 upper IC pin 7 to U 1 2 pin 1 6. 
Sdder the open end <rf'thejunq;)er connected to U7iq4>erIC pin 1 to the DPDT switdipin2. 
Prqnre and solder a short junker fixmi the DPIXTswitdi pin 3 to the DPDT switchpin4. 

Prepare and solder a short jumper fixnn the DPDT switch pin 4 (taking care to not disconnect the wire abeady there) to a 
convenient ground (for exanqde, IC 1 i»n 7 on the SOLDER side c^ the board). 

Prepare and scrider a short jumper from the DPDT switch pin 1 to the DPDT switehpin6. 
Ranove U8 (the MC14174) and prepare a 3.5** jumper. Sdder a wire to the top of pin 12 without blobing solder m the leg. 
Phig U8 back in making sure all of the pins seat firmly into the socket 

Solder the open end of the jumper ocmnected to U8 {rin 12 to the DPDT switch {un 1 taking care not to disconnect the wire 
already there. 
Skip to chedc procedure below. 

Select option 2 - using a DRIVE SELECT BIT 

Carefully lemove U12 (the 1691) firom its sod^ Bend iq> pin 16 away fiom the body. Put the 1691 back into the U12 sodM 

imddng sure that all pins firmly seat with the cxcef^km of pin 16. 

Solder the c^en end of the jimper connected to U7 upper IC]Hn7toU12pinl6. 

Remove U2 (7406) firmn the socket C3ioose a drive sdect line to use, either DS 1 or DS2 (DSO should not be used or you will 

not be able to boot, DS3 is usualfy used to access the bade i»de(tfdoiible sided drives so that can^ used either). Soldera2*' 

junq>er to pin 3 (DSl) OR pin 5 pS2) without blobing solder on the leg. Plug U2 bade into it*s socket makii^ sure all pins 

seat firmly. 

Solder the open end of the jumper just attached at U2 to U7 Upper IC pin 1. 

CHECK PROCEDURE: 

Now recbeck the entire procedure to make sure no mistakes were made. Chedc aU soklering joints for good connections. Check 
forstorts, especially by the DPDT switch. There should be NO unconnected jumper wires! If Uiere are, go through the entire 
sequence to see what you missed. Now, we need to calibmte and test the controller. 

4 



Use a multipak which will protect the CPU (you need +12 anyway) in case you made a fatal wiring mistake. Plug the 
coottoller into slot 4 as usual. Power on the muhipak, then the oomimter. If the DISK BASIC message doesn't come \xp quickly 
then shut the computer off immediatly and power everything off. Ui^lug the controller and chedc for shorts and recheck all 
oonnections against the modification procedure. If aU else Ms, you can ahv^s remove the plggybadced stacks at Ul and U7, 
carefully pull off all cfthe jumpers^ insert a new 74LS74 into Ul and a new 74LS221 into U7, pull out U12, carefully bend pins 
9 and 16 back down and reinsert it into it's socket, remove the switdi and youll be back to where you started. Presuming 
you made it past the smoke test, you will need to figure out your switch position and calibrate the controUer. 

SWITCH POSITION DETERMINATION fSkin if drive select method was chosen^ 

When the switch is in the postdcm such that pins 1 & 2 are ccmnected together (also pins 4 & 5) the controller is in the HIGH 
DENSITY enabled position (use a meter to test the connection between pins 1 & 2). When the switch is the other way, the 
normal configuration is active, which means write pttsoomp is avail^le. Pot the switch into normal position for calibratimi. 

CATrfBWATION Qg Tm Vffl; 

The controller can be caiaynited either with a scope or by trial and error. Either way, mark the original position of R8 so you 
can reverse the modification if you can not get it to woik right. 

If using a scope, connect the scope to the VCO oirtput c^the 74LS629 (Un)pin 7 and adjust R8 for 4 mhz. If doing the 
acyustment by trial and error, put a formatted RSDOS disk into drive and do a DIR fiom RSEH^ 

directoiy. You may have to do kits of DIR oonmiands. Try to find the extreme settings of R8 th^ will still imxluce a directed, 
then set R8 between the two extreme settings. The range in which the DIR will work will be quite small and your final setting 
for R8 shouM be as dose as ix)ssible to the middk of the range. THATS I^ 

To con^lete the modification you need to apfiy my IPATCH file "ccJdbttils^jpc** to the ORIGINAL Radio Shack ccStBsk 
editikm 9 (CRC $759161). You wiU also need cmew both (tf die foUowiiQ disk descriptors: tf/^i.Zdtf (high density M/4 inch 
drive) and i//_/.4L<W.(hi^ density 3-1/2 inch drive) The patdied ccSduOt detects the oki 8inch drive bit in IT.TYP in the 
drive descriptor and uses it to switoh the data transfer rate. 

Make a new OS9 boot with the new €X3Dbk and the qipropriate drive descriirtor(s) to matoh your high density drive(s). 
After booting put the switch (option 1) into the HIGH DENSITY ENABLED positum and you're ready to go. For use in 
RSDOS, the switch (option 1) should be in the ncnmalpositioa Note, the ht^ density drive is not usoaUe in RSDOS, 

P.S. please send any commems or clarifications to Oe me cm the TC^S UG board. 612-422-(»24 Robert E. Brose II 12-1-90 



EDITORS NOTE: The IPATCH file (ccSdiskhighJpc) and the hij^ density drive descriptors (dJJ.ldd and d}J.4,dd) are all 
in an ardiived file caUed CC3D1S.AR fmnd on the COLUMBIA NTS. BBS (206^(25-3804) ami 05-9 TACOMA BBS (206^ 
566-8857. Theses are both FidoNET Bnltetin Boards and tftCTC is no charge for downloading thises files. 



pwd and pxd mysteries revealed 



Ccwright (c) 1991, Zack C, Scssi(ms> CdorSystems 



OK, so there isnl an OS-9 System 
Call i^ch returns your current data 
or execution directoiy. So, just how 
do pwd and pxd do it? 
This document will att^iqH to 
explain that so that you will 
understand it Also, und^standing 
how pwd and pxd work will also 
further your knowledge of 0S*9 
Didc Structure. 

Let us begin our discussion with 
the pwd command, first. Once 
it's operation is explained and 
understood, the oper^on of pxd 
will be a relativeiy sinq>le matter to 
understand. 



First oflf, a smaU discussion on 
OS-9 Disk Structure. The 
basic entity which is omtained on 
airy disk, OS*9 ot otherwise is 
known as a file. Actually, the 
information stored on a disk is 
stored in fixed length segments 
normally referred to as sectors. 
The operating system involved 
organizes information stored in 
these sectors into discemaUe units. 
These are the files ccmtained on that 
disk. Special information is stored 
by the operating system <m the dtdc 
which indicate to the operating 
system how mai^ files there are on 
a disk, what their names are, 



where they are located on the disk, 
and how large they are. This is the 
basic amount of informaticm which 
would be required. 

0S«9 and other operating systems 
also st<M« various other information 
about each file such as the date of 
creation, date last modified, and so 
forth. With Disk Extended Color 
Basic, this informatkm was stored in 
part of Trade 17. In this 
manner, you are limited to the 
number of files the disk can store 
by the amount of space allocated to 
this q)ecial stomge area. OS-9 and 
other operating systems allows bat a 
greater capacity by storing this 



"overhead** fite ixifonnatioii in areas 
which are dynamically allocated. 
These areas are normally referred 
to as ''directories** and their related 
data structures. 

A directory is nothing more than 
a special file nuuupnlated onlytjy 
the (grating system. In the case of 
OS-9, there is also a special sector 
allocated to each file to store special 
inf<mnation. This sector is called 
the file descriptCH- sector. In 
actuality, \vithOS-9, the (mly 
information stored in the directory 
file is the name of the files it 
contains and for each file a pointer 
to the filc*s file descriptor sector. 
File descriptor sector's exist on a 
one to one conrespondenoe with all 
files on the disk. 

A file's file descriptor segment 
can be anywhere on the disk, 
it's actual location is irrelavent in 
regards to the relative position of 
the direct(»y which contains the 
file's name or to the data which the 
file contains. One sfteciaL 
characteristic of the OS-9 
disk structure which is shared fay 
sevend other operating systems is 
that a directory can contain a 
directory. This is possiUe since a 
directory is nothing more than a 
file. Therefore a directoty file, just 
as any other file has its veiy own 
unique file descriptor sector. This 
means that the directory structure on 
a disk can take on a hierarchical 
structure, a structure which can be 
conqnred to a tree. The leaves are 
the individual non directory files. 
The branches are the directories. All 
this has to start somewhere and as 
in a tree this special directory 
is called the **root*' directory. It is 
the ultimate parent of all other 
directories on the didc. The 
directory file which 

contains another directory is 
referred to as the "parent" directory 
of that directory. 

The name of the root directory is 
the same as the name of the 
device on which it resides. Thus the 
name of the root directory on a hard 
disk who's name is AiO is /hO. This 
concept is a little more confusing 
with a floppy disk drive. If you have 



two floppy disk drives, /dO and /dl, 
them tte name of the root directory 
of a floppy disk v/bkih is in device 
/do is /do, but the name of the root 
diroctoiyof that very same floppy 
dide when the disk is placed in 
device /dl is /dl. Root directories 
are a little more capable than that of 
a tree, since it can contain no! only 
directmes (branches) but also non- 
directory files (leaves). 

The root directory is 
automatically created on a disk 
when the disk is formatted, 
subsequent directories which are 
created <Htthe disk are created by 
the OS*9 System call ISMakDir. A 
sin^ user interCace to this system 
call is provided with the 
Shell command makdir. The first 
directories created on a disk 
must first reside in the root 
directory. Once a directory is 
created in the root directory, a 
directory can then be created in 
that directory. Any <x aU d these 
directories can contain non^ 
directory files or other directories. 
A lot of this m^ be review for many 
readers of this file, but {deasebear 
with me I am leading up to die 
inqxmant point here. That is, evoy 
directory always ccmtains two 
special files which are 
created autonuitically tiy the 
ISMakDir System Call. These are 
"hidden** files dnce the Shell dir 
command doesn't report their 
existance, but there are there 
nonetteless. Actually, they arent 
really files, but merely q^ecial 
entries in the directory fUe. Iliis 
will become apparent shortly. 

The names of these entries are **." 
and "..". The names of these 
entries do not actually contain the 
surrouTMling quotation marks, they 
names are just the periods. I will 
surround them with quotation marks 
to separate them for darity. These 
entries could be better referred to as 
'^inters'* to files which already 
exist The entry ",'* is a pointer to 
the directory itself and the entry "..*' 
is a pointer to the parent directory of 
the directory. M£^ an example 
will help to clear \xp any questions. 
La^s say we have a disk n^ned /hO. 



It's root directory's file 
descriptor sector ts located at LSN 
25. (ni keep this simple and use all 
decimal numbers for LSR but in 
actuality LSNs are stored as 3 byte 
binary integers.) 

Now, let's say we create a 
direct(Mry in the root direaory 
called /hO/TEXT. Let's also say that 
the file descriptor sector for 
the directory is located at LSN 50. 
The /hO/TEXT directory will 
automatically have those two special 
entries "." and **..". The LSN of the 
file descriptor sector for the "." entry 
will be 50 and the LSN for the file 
descriptor sector for the ".." entry 
will be 25. An inq[)ortant thing to 
remember is that the entry for **.." 
and **.** for the root directory are the 
SAME, because the parent of the 
root directory is the root directory 
itself 

These entries are really 
"synonym" file names. So, if your 
current data directory is /hO/IEXT 
and you ask for a directory of file 
"..", then you are really asking for a 
directory of /hO. The entries "." and 
".." can be used ANYWHERE that a 
directory name can be used. 
Forexan4}le, you can also "chd .." 
to change your data directory to 
the parent of the directory you are 
current irt 

Now, just how does pwd make use 
of this infonruition to 
determine your current data 
directory? Well, pwd first opens the 
directory file ".", the currem data 
directory, and reads the entries 
".." and ",". This gives pwd the LSN 
of the file descriptor sector f<Mr the 
parem directory and the current 
directory. If these are equal, then 
pwd has finished if s job, it is now at 
the root directcMy, If they are 
unequal, then we need to determine 
the name of the "." directory. This i& 
the main processing loop for pwd. 
The name of the "." directory is 
done by changing the current data 
directory to the directory "..". It then 
checks to see if the LSNs for ".." 
and **." arc equal. If they are, pwd is 
done. If they are unequal, it reads 
through the directory searching 
for an entry whose file descriptor 



sector LSN is equal to the 
file descrq}(or sector LSN for the 
previous "." entry. When that 
is found, we have the name for the 
{Hwious *." entry. That name saved 
away. We now have the file 
descriptor sectCH- LSN for this"/ 
entry, so we start the process over by 
changing directory to*.." again. 
When it finally finds a directoiy 
whose file descriptor sectors LSN 
are equal, it determines the name of 
the device with alSGetStt 
SS.DevNm System CaU and 
displays the completed result. 

Youll probabt^ have to read the 
previous paragraph a few 
times before it becomes clear to you 
just how this {Hocess is done. Chioe 
you understand it, it will be obvious 
to you that to perform the similar 
pxd command, all that needs to be 
done is to access the directc»ries with 
the execution bit set! In fact if you 



conqiaft the pwd program with the 
pxd program, there are only 4 bytes 
whidi aredififerentt (Not counting 
the 3 CRC bytes, <^ coursel) And 
two of tho6e4e four are the internal 
names of the programs! So 
actually, there are only two bytes 
which are effectively different for 
the two programs and these are the 
two bytes which control the 
access mask for the I$Open of the 
"." directmy and the ISChgDir to 
the ".." directory. 

If you can read C, I have incliKied 
the equivalent code in C for the pwd 
conunand and the pxd conunand. 
Whik it would be 

extremely inefficient for you to 
oonqnle and actually use these 
programs they are included for 
instructional purposes only. See, the 
(Miginal pwd and pxd commands are 
written in ASM, which makes their 
binaries much smaller! If you wish 



to incorpcmite the code from these 
two im>grams in a program you are 
writing to avoid forking pwd 
and/or pxd commands, you are most 
welcome to do so! The>' were 
written in a form as to NOT require 
any special library, they will 
conqnle and woric just fine with the 
stock cl9}.l which comes with the 
MicnnvareC Con^iiler for OS- 
9/6809. In fact, even though pwd 
could have been written slightly 
siiiq)ler using the Kreider Lib, pxd 
woukt not evenbe possible, since 
there is no option wi^ the opendiiO 
function to open the directory with 
the execution bit set, which is 
required by the pxd function. 

I hope this file and the associated 
C program sources has helped 
increase your knowledge and 
understanding of OS*9 and its disk 
fiile structure. 



C Tutorial 

Chapter 2 







LETS PRINT NUMBERS 

Type in the listing named ONEINTX and dis^ilay it m 
the monitor ffu* our first examfrie of how to work with data 
in a C program. 



ONEwrc? 






ints i.ncl«3cy 




lyieiwK i*- X3y 




S»ari.nti« ( •*'ri:i« ^rrnXx^m or 


<tinfli 


i.n«fl*>c Xm %<flSn" ,±ncl«i»c> y 




i.r»«X«ix — a-^F 






^txm JLna«>c 




dLntil«3c — XO# 




ppintidr C ••rm«i vttXu« oC 


^^m JLncA4»9c 


S.m %<aNr*»« , i.nci«9c > 9 





Listing 4 

The entry point "main** should be clear to you by now as 
well as the beginning teace. The first new thing we 
encounter is the line containing *'int index;**, which is used 
to define an integer variable named **index**. The **int'* is 
a reserved word in C, and can th^efcm not be used 
for anything else. It defines a variable that can have a 
value fix>m *32768 to 32767 on most microcomputer 



implementations of C Consuh your users manual for the 
exact defiiution ibr your confer. The variable name, 
**index**, can be any name that follows the rules for an 
identifier and is not one of the reserved words f<»r C. 
Consult your manu^ far an exaa (kfiniticm of an 
identifier for your oon^xiler. The final character on the 
line, the semi<<don, is the statement terminatcM' used 
inC. 

We will see in a kuer chsqiter that additi<mal int^ers 
could also be defined cm the same Une, bm we will not 
ccnnplicate the present situatiott 

Observing the main body of the program, you will notice 
that tha:e are three statements that assign a value to the 
variable **index^ but only one at a time. The first one 
assigns the value of 13 to *'index**, and its value is printed 
01^ (We will see how shortly.) Later, the value of 27 is 
assigned to '*index'*, and fin^ 10 is assigned to it, each 
value being printed out It should be intuitively dear 
that *'index** is indeed avariaUe and can store many 
different values. Please note that many times the words 
**printed out** are used to mean *'di^layed on the 
momtCM-**. You will find that in many cases experienced 
piogrammers take this liberty, probably due to the 
**printr function being used for monitor display. 

To keep our promise, let's return to the **printr 
statements f(nr a definition of how they work. Notice that 
they are all identical and that they all begin just like the 
*'printr state»nents we have seen befcm. The first 
difference occurs when we come to the % character. This 
is a special character that signals the output routine to 



stop coiiying characters to the output and do something 
different, namely output a variable. The % sign is used to 
signal the start ci many dififerent types of vari^les, but 
we will restrict ourselves to only one for this exanq>Ie. 
The character following the % sign is a "d", which 
signals the output routine to get a decimal vahie and 
ou^ it Where the decimal value comes from will be 
covered diortly. After the "d", we find the femiiiar "ta", 
which is a signal to return the video "carriage", and the 
closing quotaticm mark. All of the characters between 
the quotation marks define the pattern of data to be 
output by this statement, and after the pattern, there is a 
comma followed by the variable name "index**. This is 
where the "printT statement gets the decimal vahie which 
it will ouqnit because of the "%d" we saw earlier. We 
could add more "%d" ou^mt field descriptors within (he 
bradcets and more variables following the description to 
cause more dala to be printed with one statement. Keep 
in mind however, that it is important that the number of 
field descriptors and (he number of variable definitions 
must be the same or the runtime system will get confiised 
and probably quit with a runtime error. Much more 
will be covered at a later time on all aspects of input 
and output formatting. Areasraably good grasp of this 
topic is necessary in ofdet to understand the following 
lessons. It is not necess^ to understand evetythtAg 
about output formatting at this time, only a fair 
understanding of the basics. 
Compile and run ONEINT.C and observe the ontpat, 

HOW DO WE ADD COMMENTS INC 

Load the file COMMENTS.C and observe it on your 
monitor f^ an example of bow comments can be added to 
aC prc^ram. 



COMMENTS^ 

/* X*]r%J.4» i.« A ooxiun«inl£ ±9rftoar«cSI toy 

X^noarwcjl toy '^to* ooinpXX^xr */ 

AlXowMcS -tio to* 
oonti±ntji4»«l on 

> 



Listings 

Comments are added to make a piDgram vook readable 
to you but the cominler must ignwe the comments. The 
slash star cond>ination is used in C for comment 
delimiters. They are ilhistrated in the program at hand. 
Please note that the program does not illustrate good 
ocmunenting practice, but is intended to illustrate where 
conmients can go in a program. It is a very sloppy 
looking iHogram. 

The first slash star combination introduces the first 
comment and the star slash at the end c^ the first line 
terminates this comment. Note that this comment is prior 
to the beginning of the program illustrating that a 
comment can precede the program itself Good 



programming practice would include d comment prior 
to the program with a short introductory description of 
the program. The next comment is after the "mainO** 
program entry point and prior to the opening brace for the 
program code itself. 

The third comment starts after the first executable 
statement and continues for four lines. This is perfectly 
legal because a comment can continue for as maiiy lines 
as desired until it is terminated Note careftilb' that if 
anything were included in the blank spaces to the left of 
the three continuation lines of the comment, it would be 
part of the comment and would not be ccmq>iled. The 
last comment is located following the completion of the 
program, iUustn^ng that comments can go nearly 
atiywhcre in a C program. E7q>eriment with this 
program by adding comments in other places to see what 
will happeit Comment out one of the printf statements by 
putting comment delimiters both before and after it and 
see that it does not get printed out. 

Comments are very tnqx>rtant in any programming 
language because you will soon forget what you did and 
why you did it It will be much easier to modify or 
fix a well commented program a year fit)m now than 
cme with few <»- no comments. You will very quickly 
develop your own personal style of co mment i n g. 

Some con^iers alknv you to **nest" comments which 
can be very hanify if you need to "comment out" a section 
of code during ddnigging. Cbed; your conqslor 
documentation for the availability (rf* this feature with you 
particular compiler, Congiile and run COMMENTS.C at 
this time. 

GOOD FORMATTINC STYLE 

Load the file GO(»>FORM.C and observe it on 
your monitCH^. It is an examine of a well formatted 
piogram. 



GOpDFORM,C 

E>3rXni=.tf ( «oi»n »XcS Xtt 

•• > y 

X>3rXn'«;£ 

parXnt^C "Atia to«i<A :ro*no •• > y 

* pK'Ocraraxn ** y $ 
K>irXn^jr 

( "unir*«<AAtoX«i . \n»« ) w 



Listing 6 

Even though it is very short and therefore does very 
little, it is very easy to see at a ^ance what it does. With 
the experience you have already gained in this tutorial, 
you should be able to very quickly grasp the meaning of 
the program in it*s entirety. Your C com|Hler ignores all 
extra spaces and all carriage returns giving you 
considerable fieedom concerning how you format your 
program. Indenting and adding spaxx& is entirely up to 
you and is a matter of personal taste. Compile and run 
the program to see if it does what you expect it to do. 



Now load and diq)ldy the program UGLYFORM^C and 
observe it How long will it take you to figure out what 
this program will do? 



mm^^^ M.. 



C *'ottn m±€3k 
pxroeraraiin • \n' 






in 



And l»«iia £^ox*m 



*> # 



Listing? 

It doesn*t matter to the oonqiUer which fbrmat style you 
use, bat it will matter to you when you try to debug your 
program. Compile this program and nm it You may be 
surprised to find that it is the same iMogram as the last 



one, excq)t for the formatting. D(m*t g^ too worried about 
formattitig style yet You will have plenty of time to 
develop a style ofyour own as you learn the language. Be 
observant of styles as you see C programs in magazines. 
bocla, and other ptd>lications. 

This should pretty well cover the basic concepts of 
programming in C bi^ as there are many other things to 
team, we will forge ahead to additional program structure. 

PI^QfiRAMftflWC P^ffRQ^IE? 

1. Write a program to diq^lay your name on the monitor. 

2. Modify the |Hogram to display your address and 
iriKme ntnnber on sq)arale Unes by adding two 
additicHial "printT statements. 



NWCoCo Fest UPDATE 

The Best Western Bayview Iim. in Bremerton is oSmng m a spocM gnnv rate. They have set aside 20 rooms far CoCo nuts 
and their c<Hig>amons until the end of May. A sinp ie room is only S55, A double is $58. To get these special rates, ocxitact: 

Beades the nicdy qypointed nxmis there is an indow po(4 and hot 
tid>. Several ooiQ>tes mentioned how relaxing that was last year. There is a 
pailc for walking (a morning run) just two Mocks away. There are also 
discount tidcets ts» the gym that is right next door to the Bayview. Of 
coitfse, there is a lounge and fine restaurant right in the Irm for those wlio 
want to stock up cm calories instead of dqdete them. 

Bremert(m is the home of the Puget Sound Naval Ship Yard and again 
the home of the battleship USS Missouri. It is only about 10-15 minutes 
fixmi the CoCo Fest II Gmference site. L^ Betty know that you are interested in the tourist attractions whfi«i you call or write. 

Bob van der Poel is the first m^ speaker to confirm. Ife wiU attend theentire event. He wiU be available fot 

personal chats, be our keynote speaker, and will give a special presraitation about the language C. Bob is the aadxx- of the 

highly rBq)ected and used Ved Text Editor, VfHrint Text Formatter for 0S9, and the every popular Telewriter word (hoocssch^ 

fi>rtheCoCo. 

Finally, the planning peqde want to tet you know that there is a second in the series of CoCo Fest mugs crating. A new 

design, a new collectable. WiUiyourregistrati(mtheyareonly$5^iece»$25foras^of$ix. The mugs will be S6 at the Fest. 

There will also be a fibulons T^durt and even more t We don*t want to give away all the surprises 1 



"Betty", Groups Coordinator 
Best Western Bayview Irm 
CoCo Fest II Convention 
5640 Kits^ Way 
Bremerton, WA 98312 
1^00-422-5017 or (206) 373*7349 
Fax:(206)377-8529 



Club Activity Report 

Bellingham OS9 Users Group - Longview CoCo Club 
Ml Rainier CoCo Club- Port O 'CoCo Club - Seattle 68xx Mug 




WBBilaiBOIIIbiralRnp 

1 he First OfiScial Meeting of 1992 
was held at the Bellingham Public 
Lilnraiy on Wednesd^, April 22. 
The room was perfect for our needs 



with a blade board, video tapes, 
overhead prcgectCHis, large taUe, etc. 
UnfiMtunately we were very fiw in 
numbers. Only 5 were in 
attendaiK^e. But this was only the 
first meeting and it takes time to get 
thewordout Right?! 



First order of business was to have 
each attendee introduce themselves 
and tell the others about their 
Qmiputer systems and what Uticy 
warned to gain fi^om the club. It was 
interesting that everyone had several 
CoCo systems ^nj and IBM Clone. 



REGISTRATION FORM 



NAME: 



MAEJNG ADDRESS:. 
CITY: 



ST/PROV: 



ZIP/POSTAL CODE: 



EVENT 



INCLUDED SEPARATELY 



FRIDAY EVENING 

7:30p.in. NotaUe Video Tape Presentations YES 

9:0<^.in. PuUic Domain/Shareware Sw^ YES 

SATURDAY: 

7:30a.m. Satwday Sw^ Meet setiq) time n/a 
8:13a.m. No Host Breakfiist about $5.00 

9:00a.m. Conqrater Swqi Meet YES 

10:30a.m. Preliminary speakets YES 

(Speakers to be amwunced) 

12noon Loncbeon & Keynote Spesiket YES 

— featuring Bob van der Poel ■ 



$3.00 


$3.00 


n/8 


$6.00 


$3.00 


$3.00 



$12.00 



1.30p.m. Woikshqx YES 

Session 1: tobeanoounoed Sessi(Mi2: 


$3.00 
tobeannounced 


3:00p.m. WoAshqw YES 

Session 3: tobeannounced Session 4: 


$3.00 
tobeannounced 


REGIS'l-RATIONFEE: $20.00 $30.00 

(Remember, Satuid^ No Host Break&st $S/$6 extra) 


N9tthwe?tCpCoF<f«iv^It«m#AY»ilaW^ Otd¥rNow 


A^Fc^n 



CoCoFcstttKfugs $ 5,00 $ 6.00 

Set of Six $25.00 $30.00 

T-Shirt (Men's M L EXL) $ 8.00 $10.00 

Extra Extra Large add $2.00 Your Naoie as part of design add $2.00 

Desired Name(s): (size ) 



Second name: 
Third name: 



(size 
(size 



(All amounts are U.S. Currency only) 



NorihweaCoCoFesihai 3046 Banner Rd. SE.» Port Orchard, WA 9S366 (206)871-6539 



Advertisemem wait out 
annoumnng that this was a Color 
Computer Club, yet everyone was 
ntercsted in their CoCo because 
they wanted to learn mote about 
OS9. 

Second order of business was to 
display the club ofiferings and 
benefits, from the Ncwdettcr to the 
Public Domain Library, to technical 
assistance. 

Third order of business was all 
the recent gossip the NW CoCo 
Fest. We are aU veiy excited about 
Bob van der Poel, atid at least four 
of are planning on going. 

Last order of business was a 
review of Multivue and the currently 
available iq>grade files and patches. 
Shell+ was reintroduced and a hard 
drive boot disk with the Multivue 
Term and windows was created 
using Burke & Burke's EZGEN, 

Next month a denumstralion will 
be provided by Rodger Alexander on 
the ways to use AIF files to improve 
the peiibnnance (»r Multivue. 
- Rodger Alexander - 

III Islnier CoCo Cluli 

Our April meeting started off with a 
demonstration t>y Randy 

Kirschenmann of his "C" program 
that will display a text file 
b^kwards on the screen. The 
members stated several uses for this 
program which included a good 
exercise in using ''C*. Randy then 
siMnved the source code and 
explained how each line worked. 
Chris Johnson then brought the club 
up to date on the upcoming N.W. 
CoCo Fest n. It will be even bigger 
and more interesting than last years 
Fest. So clear you calendars for 
June 26th and 27th and plan to 
attend. 

The rest of the meeting was devoted 
to open discussions of several 
sid>jects. Michael Stokes' series on 
**€** had to be delayed by a month so 
he will begin it at the next meeting. 
It should be great for both the 
liginner and e?q)erieticed '*C" 
programmers. 

" Alan Johnson - 



8s8ttle 66m llug 

Ihe April meeting was very 
informative. First on the agenda 
was a hardware presentation 
showing how to add a second drive 
to a Color Computer Syi^m. 
N(Minally this is no big deal and 
very easy to do. However, in this 
case the two drives used were the 
two worst possible cases. The first 
drive was a new FD-502. The drive 
configuration jumpers are located 
under the circuit board and without 
any labels. Also the jumper pins are 
arranged in a 90 dq^ree angle and 
not in the usual configuration. The 
jun^r positions are paralld to the 
back edge of the drive rather accross 
the jumper pins as with most drives. 
It actually boils down to trial and 
error. Note the de&ult positicm of 
the jumper and them move the 
junq;)er (town two pins. 

The second drive was an original 
35 track, single sided drive that bad 
no drive select junq>er setting on the 
circuit board at all. However, three 
solutions are possible. The first (me 
is the Radio Shack method: Get an 
old Radio Shadu drive c^le with 
the card edge connectors that have 
the missing contacts. The end 
connector has it*5 contacts puUed to 
configure the drive for Drivel, 
while the second connector has it's 
contacts pulled for Drive 0. 

The second method is to cut the 
wires on the cable to the drive 
disatriing the DriveO aiKl Drive3 
circuits. 

The third method is to cut the 
trace lines on the circuit board that 
connect to the card edge connector, 
again disabling the DriveO and 
Drive3 circuits. We tried this 
method and it worked! 

Next on the agenda was the PDS 
Ikaabase. A sample SEARCH 
Procedure was dis^yed on an 
overhead projector. Everyone 
partidpated in debugging the 
sample code until it was determined 
to be perfect. This is the SEARCH 
procedure featured in this 
Newsletter. However, it took 



several more modifications to get it 
to actauUy work properly!!!!! 

Donald Zimmerman from the Port 
O'CoCo Club was present at the 
meeting and updated us regarding 
the NW CoCo FEST in Port 
Orchard on June 26th and 27th. 
Donald also was seeking 
suggestions for improving the 
format and/or sut^ matter. Most 
of those in attendance indicated 
their intentions to attend. 

Finally, Rodger Alexander took 
orders for a special purchase of 
720K floppies and 20Meg Hard 
Drives. The final tally was 7 
fl(4]pies @ $20 each, 1 Hard Drive 
for $85 and 2 Hard Drive controller 
cards for $12 each. 
- Rodger Alexander - 

Port {MIoCo 

It was like a faiiy tale gone awry. 
Of course, it had a happy 
ending. Thafs a given. It had a cast 
of notable people. Those stories 
always do. There was drama, action, 
disappointment, and goodness 
overcoming all at the end. Well, 
that was April's meeting. 

There was a plan, a stotyline. 
Guests speakers had been 
invited, rep^edly. PiAlicity had 
been created and delivered to the 
harolders of the day, the 
newspsQKrs. The grapevine had 
been used to spr^ the wonL 
everyone bad been called about this 
great event. 

Now for the drama. The guest 
speaker was contacted 20 minu^ 
before the meeting to m^ sure dl 
was wdl in the kingdom. It wasnl 
His newcfiariot had t^lown a 
transmission. Goodness would harve 
it that he had an extended warranty 
on it (we WOT*t give names here). 
So the focal point of our meeting 
had just gone dead in the water. 
Well, life will continue. 

A few people had said that they 
had equipment they were thinking 
of liquidating, ... for a price. You 
never know if they are going 
to materialize or not. Two of them 



never did. There were three boxes 
of CoCo "stuff** at the home of one 
mentber. The night before the 
meeting it was discovered that he 
was out of state because of a &mily 
death. Attempts were made to get 
the stuff to the meeting anyway, 
maybe. 

Seven pm rolled anmnd and it 
looked like a national meeting 
ofveteransofthe Civil War. If we'd 
been holding hands with each other 
I would have been hugging myself 

But then then the light began to 
show on this dismal story. 
People started wandering in between 
7 pro and about 8:15. And the 
group grew to areqsect^le 16 
people. The CoCo "stuff* arrived 
Tom Brooks, in his time of sorrow, ^^ 
had seen that the CoCo stufT'^ 
collected by the Conq>ater %nk 
Charity was or its way to die 
meeting. A young man who had 
had an extensive system came 
iodcing for a way to clean out some 
of his space by getting rid .of 
his CoCo stuff, several bo7Qe$;^ it 
We ma<te, ammgemems |2[ hi^ to 
donate everything to the Conqputer 
Bank ChariU" who in turn would 



allow the Port O' CoCo group to sell 
it for siq>porttng funds for the 
charity. The bidding started slo^y, 
vei>' slowly. But a spark occurred 
and things started ptddng up. And 
before it was all said and done $160 
was raised for the CBC. And a lot 
of pCQ^e held in their clutches 
hardware, scrftware, and other stuff 
they REALLY wanted. 

A major part of tl^ meeting was 
devoted to talking about the 
iqKoming CoCo Fest 11. The date 
has been set for the 26-27th of June. 
The facility has been committed and 
the dimiing arrangemCTts have been 
selected The event will be in Port 
Orchard at the HiJoy Bowl. Things 
will begin Friday evening with 
ptesentatioos tmtil they throw us 
o«. There is a JNO,HOST 
break&st Saturday at about 8 am 
and then a luncheon at noon with a 
keynote speaker. We discussed the 
desirriHtity of various novelty items 
for tibe FEST. Eventhough we had 
a miig last year, just about eveiyone 
wanted another mug. So we will 
have the second editicm of the CoCo 
Fest mug. Also we will have a T- 
shirt, A sreat T-shirt, if I may say 



so. Discounts will be available 
for everything when ordered in 
advance. (See registration form 
elsewhere.) 

Although the meeting was 
nothing like it was planned 
goodness or si^cess triumphed over 
chaos. We had a very worthwhile 
meeting. 

But that's not the topper! When I 
got home I found out that Bob 
van der Poel. called me to accq>t the 
invitation to be the CoCo FEST 
keynote speaker. He will also attend 
the whole evem so everyone will 
have a chance to talk with him on a 
1:1 basis. Bob is the author of the 
ftmous WED TextEditor & Vprint 
Text Formatter. He offered also to 
talk at erne d the w(Hi^hops on the 
language C. 

So this stoiy has a more than 
happy ending. It has the potential 
of a fantastic convention for the 
CoCo community and a significant 
contribution (S160) to the Conqniter 
Bank Charity. What more could we 
want? "And so they lived h^)pily 
ever after." 

- Donald Zimmerman - 
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